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E.G.0.S. Version 1.5 TECHNICAL INFORMATION 


E.G.O.G. «Entorno Grafico OPERA SOFT) is a program with puli- 
sown menus, icons, etc., designed to facilitate the use of the MSX-DOS 


cperating system 
Alsc, it is a very powerful tool the programmer can use to 
develop kis applications on, ie: he can use the basic routines 


impiemented in EGOS such as icons draw, windows, menus, rectangles, etc. 
EGOS runs in graphic screen mode 6. In this mode the screen has 
a resolution of 5128212 pixels and 4 colors from one palette of 512 


our dp 5 of video-ram are available. The sprites are disabled and all 
i ear 


ing on the screen are written in bit-image mode. 


EGOS, these penitence and EGOS itself run on an alternative memory bank, 
E 


provi G Ling ne entir 


1254 ram or more, and 128K vram. 


; o bank 
SE C EE 0. ie: when a Lai is running in IPA, 
Ter SAS D$ E G OSa the area between C000-FFFF is available 
È 4! for EGOS and application programs. EGOS 
GAR ees i al UM po aa e sanza does not modify this area, so it is 
T VO e ni usad to pass parameters or data to the 
: ae basic routines. The stack and the user 
Se ean EE interrupt routine must be located in 
MENT Ss UR. 3 this area. 
L 6 See appendix I te further 
EE information 


E.G.O.S. Version 1.5 TECHNICAL INFORMATION 


U2. 19 E.G.O.S. APPLICATION USE 


EGOS provides several functions that users can call from their 
programs, the majority of which are graphic input-output routines such 
as mouse movement, rectangles, icons windows, etc. The way to use these 
routines is as follows: 


EGOS has a pointer table to the GIOS routines. It also has a 
routine that the user must call to execute GIOS functions. This routine 
is located between 8000-BFFF memory address. When EGOS runs any program, 
it writes in memory 2c and 2d this routine address. The user must read 
these two values to patch in his GIOS CALL routine, as will be 
explained later. 

The user must write a short routine to change the RAM 
configuration, executing the GIOS CALL routine and returning to the 
application. This routine must be located between COOO-FFFF. 


To call a GIOS function, the user must send EGOS GIOS routine 
the wanted function number in the IY register. 


The following listing is one example of a GIOS CALL routine. 


z80 
pago equ Ofch ;memory mapper port from GGUU-SFFF 
pagi equ Ofdh ; memory mapper port from 4000-7FFF 
pag2 equ Ofeh ;memory mapper port from 8900-BFFF 
. phase  0C000h 
GIOS CAL execute GICS functicr 
entry : iv function numer 
glos CAia: 
push serve aocumu:ator al tas 
id A, 4 enable EGOS RAM d iat Lo 
cal setram 
pop At restore accimuiator and tiags 
xmodú: cali GIGS scali GIOS 
push af ;preserve acumulator and flags 
id a,i restore RAM configuration 
call setram ; 
pap af ;restore accumuiator and {lags 


ret «return to caiter 
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: SETRAM enable bank memory 
; entry: a= first 16K block 


modifies: af 

setram: 
di ;no interrupts 
out (pag2),a ; RAM 8000-BFFF 
ei ;interrupts 
ret ;return 
end 


The user must patch the GIOS call address before calling this 
routine. 
He may take the following action: 


ld hl, (2ch) ;GIOS call address 
ld (xmod0+1), hl ;patch the address 
[2.2] INTERRUPTS 


To work in EGOS, a user interrupt routine is necessary to move 
the cursor on the screen. The user must write his own interrupt routine 
intercepting the system one, using the hook reserved for this purpose 
(H_TIMI = FD9F). 

The user interrupt routine must be located between C000-FFFF. 
The only GIOS function the program may call is _ACTMOU (move cursor on 
the screen). The programmer must preserve the hook and execute it 
when the interrupt routine finishes. Also, he mst restore the hock on 
program ending. 


This is an example of user interrupt routine. 
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. 280 


Memory mapper ports 


pago equ Ofch 
pagi equ Ofdh 
pag2 equ Ofeh 
H TIMI equ Ofd9fh 
.ACTMOU equ 26 
3 INIEGOS init interrupt routine 
iniegos: 
di ;no interrupts 
ld hl, (2ch) ; GIOS address 
ld (xmodl+1),hl i patch address 
ld hl, H_TIMI s H_TIMI HOOK 
ld de, memint ;save it 
ld bè; D ;9 bytes 
ldir ; 
id a, 0c3h IP (Jump) 
ld CH TIMi),a ¿first byte of HOOK 
ld hl, intrup ;intrup=user interrupt routine 
pi OH TIMI+1), bl 4 
ei ;enable interrupts 
ret ; 


intrup: 
in a, (page. preserve RAM from 6000 to BEFS 
ld (memram: aâ ;save it 
ld a,4 ;set EGOS RAM from 8000 to BFFF 
OUÈ (pas2),a : 
id iy, ACTMQU ; ACTMOU GIOS function 
RADA LE. wal: GIOS 
id a, (memram) . set application RAM 
out Lago sa i from 6000 to BEP 
memint: 
def: 5 ;execute oid HE TIMI 
memram: 
defs i ; 1 byte storage 
end 
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The _ACTMOU function writes data in VDP registers. The user can 
not access VDP register when cursor is on the screen. If one wants to 
write data in VDP, then he must hide the cursor with _OCUCUR GIOS 
function, writing data and showing cursor with _MUECUR GIOS function 
The GIOS functione listing, in field NOTES, shows which functions need 
to operate in that way. 
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——————————————————————————————————————————————————————————————————— 


The user must write an error trapping routine when using BDOS 
disk functions. This is necessary because EGOS runs on a graphic screen 
and messages from the operating system are lost. The programmer may 
write this routine using MICROSOFT rules. These rules specify how the 
routine can corrupt all registers except C and SP. Authors have found 
problems not preserving IX register. 


In using the EGOS Diary option in application programs, the 
error trapping routine must be located between C000-FFFF. In any event, 
the user must provide a warm start entry for 'Cancel' option into his 


program. 
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Due to unknown reasons, the system crashes when BDOS disk 
functions are called and the user interrupt routine has very heavy work. 
It is possible to correct this by intercepting the BDOS jump vector and 
seeing whether or not a call to a BDOS disk function is requested. On 
requesting a BDOS disk function, the user must disable EGOS interrupts, 
calling BDOS and restoring registers. 


This is a listing exampie of BDOS interaction routine: 


. 280 

inibdos: 
id hl, (6) ;old BDOS vector 
id (bdos+1), bi ;save it 
ld hi; fitter ;new BDOS vector 
ld (6), hl isave it 
ret sreturn 


€; NOfIIt es 

SI 029h SEDe RAN-WRITE WITH 
ZERO FILL 

jt nc,nofilt ;yes, do not filter 

pop af irestore accumulator and 1145 

SALI noint sno user interrupts 

cali DANS jexecute bios 

cal siint serable user interrupts 

ret return to caller 
nofilt: 

pon af restore accumulator ami flags 

odios: To 0000 ;old BDOS jump vector. 
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noint 
di ;no interrupts 
push hl ; preserve hi, bc, de 
push be ; 
push de t 
ld hl, memint ;old interrupts (SEE INTRUP) 
ld de, H TIMI ;H_TIMI HOOK 
id 56,5 ;9 bytes 
ldir ; transfer 
pop de ;restore registers 
pop bc i 
pop hl ; 
ei ;enable interrupts 
ret ;return 
: SIINT enable user interrupts 
siint: 
di ino interrupts 
push af ;preserve accumulator 
push hi ;preserve hl 
ld hl, intrup ;user interrupt routine address 
id a, 0c3h ;JP (JUMP) 
id (H_TIMI),a ; 
ic CHATIME IN NS ;set user interrupt routine 
pop hi irestore ni 
pap af ;restore af 
ei ;enable interrupts 


Lé 
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EGOS runs in screen mode 6 and provides 4 pages of video-ram fo! 
use. 512#1024 pixels are availabie. EGOS uses page © and page l for 
active pages, and page 2 and 3 for storage pages. 

The character set resides in VRAM page 0. The pattern address is 
222,0 (Y,X pixels address) and every character has 8*8 pixels. The 
cursor icon also resides in this page. Its address is 212,0 (Y,X pixels 
address) and it has 12*10 pixels. 

One can use a 256 character set in screen mode 5 and 7 but in 
mode 8 he can oniy use a 128 character se The i s ir 
page i at address 468,0 (Y,X pixels address). 


The user may locate his icons anywhere to mantain the VRAX pages 
2 and 3 free. On using .Q MENU, CALCUL, _C_FORM, or .FANEL, he must 


know that these routines save their background in page i if page Ô is 
activated or visa versa. 


This is the VRAM memory mar showing how it is used by 


U 
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GIOS graphic functions only run in screen modes 5, 6, 7 and 8. 
The user has only 2 VRAM pages in modes 7 and 8 and, consequently, he 
can not use _CALEND, | CALCUL and PANEL because these routines use icons 
defined in screen mode 6. 


When EGOS runs a program it sets screen mode 0. This action 
z the VRAM page 0. if the application needs to use GIOS 
a ies, the user must load cursor and character definitions in VRAM 
using _CURSTD, .CARSTD or .CA CUR and .CA CAR GIOS functions. 
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EGOS is a graphic environment using poligonal forms, windows, 
icons, etc. Each object is defined by one descriptor, ie: a list of 
bytes defining its type, position, dimensions, etc. 

Descriptors used in EGOS will be explained in this chapter. 


Rectangle descriptor is a 6 byte list as follows: 


position x +0 2 bytes 
position y +2 1 byte 
dimension x +3 2 bytes 
dimension y +5 1 byte 
(3.2) VIRTUAL SCREEN DESCRIPTOR 


Virtual screen is a zone of the entire screen that users van 
define as output for text. It is possible to define several virtual 
screens and write text on the wanted screen. It is possible to assume 
that a virtual screen acts like a screen window. Text on a virtual 
screen is written in bit-image mode. Routines to write text are capable 
of clipping characters that overflow the window. 


This descriptor is as follows: 


locate x +0 2 bytes (internal use) 

locate y +2 1 byte ‘internal use) 
position x +3 2 bytes (at the entire screen) 
position y 45 1 byte (at the entire screen) 
dimension x *6 2 bytes (in pixels) 

dimension y *8 1 byte (in pixeis) 

flags +9 1 byte (internal use) 

total bytes: 10 
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` MENU DESC 
; Ç 
Menu. fa a Enge G 
8 
screen. its. dewerigter 15 as 
numos: Les 


submenu descriptor 


4*4*n 


ones can in undefined 


The text is a line of words, each of which is separated by two 
spaces, finishing with 0. 
The foilowing iisting is an example of menu descriptor: 
menu: defb 3 ; 3 entries 
defw menu text ; Menu text 
defb 2 ; column of first char 
defb U ; internal use 
defw sub. menui ; submenu 1 descriptor 
defb 0 ; next column 
defb 0 ; internal use 
defw sub menu2 ; submenu 2 descriptor 
defb G ; next column 
defb 0 ; internal use 
defw sub. menu3 ; submenu 3 descriptor 
defb 0 ; internal use 
menu_text: defm ‘ Desk Actions Edition ' 
defb 0 
SUBMENU DESCRIPTOR 
number of entries +0 1 byte 
Maximun width in chars +1 1 byte 
Text address +2 2 bytes 
Selection flags +4 1 byte for each entry 
End of descriptor +4+n 1 byte =O 


line, putting the right vaiues on. 
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iine of 


+0 1 byte 

+1 2 bytes 

+3 4 bytes each entry 
1 byte 

i byte 

2 bytes 


+3+4#n 1 byte (internal use) 


The column valve of the first entry must be user defined. 
i because this routine checks the menu 


The 
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with G. «Each entry must 
Ocated at the beginning 


D 4 s 
y . t ne selection mark». 
Ea Eni cedet Pai 
Sub menul: ni 3 i 3 entries 
jor 13 : 11 bytes of wicth 
; pointer to text entries 
à ; Selectable 
: 125 ; Selectabie 
Gef 128 ; seiectabie 
iefp Ü ; end of descriptor 
smenuit: deli w EaR ZT 
deit ió ;iine feed 
áefm * ‘Option. 2' 
defb 10 ;line feed 
deim " Option 3° 
Gei 0 ; end of submenu text 


R =i selectable 
=U no selectabie 
bit 4 =3 marked entry 
=0 not marked entry 
(3.4) FORM DESCRIPTORS 


Form is the name of a graphic objects structure used to define 

f a dialogue, window, etc. One form can be a single object or 
jects. The most complicated object is a tree. le: a structure 
‘ ì objects. One object of tne tree can be another tree, etc. 
The maximum structuration level is 4 (one tree of trees of trees of 
F 


trees) 

The following listing shows the EGOS predefined objects. 
TREE = 0 

Objets tree 

flags +0 1 byte 

object type +1 1 byte =TREE 

coord x +2 2 bytes 

coord y +4 1 byte 

dimension x +5 2 bytes 

dimension y +7 1 byte 

objects number +8 1 byte 
m pointer to first object +9 2 bytes for each object 


total bytes a+2#n 


L 
ri E.G.O.S. Version 1.5 TECHNICAL INFORMATION 
| Note: The coordinates vi objects defined in a tire are 
RELATIVE to the origin of this tree. 
| BITIM = 2 
Bit image object 
| flags EA l byte 
object type +] 1 byte =BITIM 
coord x *2 2 bytes 
coord y tá i byte 
| dimension x T3 Z bytes 
dimension y FL 1 byte 
| 7 coord x in video-ram tè 2 bytes «where the icon is 
\ defined) 
coord y in video-ram +10 2 bytes (where the icon is 
| defined) 
total bytes: 12 
| BOX - 4 
Cn!or box with borde: 
| flage +0 1 byte 
Object type +1 1 byte =BOX 
coord x +2 2 bytes 
coord y +4 1 byte 
dimension x +5 2 bytes 
dimension y LE 1 byte 
border colour +8 1 byte 
| background colour +9 1 byte 
( total bytes: 10 
| TEXT = 6 
i Simple text 
| Flags +0 1 byte 
object type *I 1 byte =TEXT 
coord x +2 2 bytes 
| coord y +4 1 byte 
text address 15 2 bytes 
| total bytes: T 
Pag: ID 
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| EDTEXT 


routine. 


| CHAR 


| RECTAN 


BARR 


Ke EN ee 
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= D 
Editable text 


Flags 

obiect type 

coord x 

coord y 

text address 
characters. number 
edition tlags 


total bytes: G 


The byte ‘edition fiags' 


= 10 
Character 


flags 

object type 
coord x 

coord y 
character code 


total bytes: 6 


= 12 


+8 


is the 


Va res DÄ ka PO e rä 


control 


Rectangie with or without shadow 


flags 

Object type 

coord x 

coord y 

dimension x 

dimension y 

color 

Number of shadow lines 


total bytes: 10 


= 14 
Color rectangle 


flags 
object type 
coord x 
coord y 
dimension x 
dimension y 
color 


total bytes: 9 


+0 
*1 
+e 
+4 
+5 
sT 
+8 
+9 
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hyte 
byte 
bytes 
byte 
bytes 
byte 
byte 


=EDTEXT 


value sent to the 


: CHAR 


byte 
byte 
bytes 
byte 
bytes 
byte 
byte 
byte 


=RECTAN 


byte 
byte 
bytes 
byte 
bytes 
byte 
byte 


=BARR 


„INPUT 


ap — 


U 
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TEXTI. : it 
limited text 
fiagi tu i byte 
gijeet type +i i byte =TEXL 
coord x EE 2 bytes 
coord y +4 | byte 


, e 2 A 
text address +5 > bytes 
length in chars cP 1 byte : 
totali bytes: 8 


This object is used when the length of text must be greater than 
the available space on the virtual screen. This object is used in EGOS 
by the directory information line. (bytes free and number of files) 


TEXTF = 18 
Formatted text 
Flags +0 i byte 
object type +) l byte -=TEXF 
coord x +2 2 bytes 
coord y +4 ] byte 
number of text +5 2 bytes 
2 bytes each one 


pointer to text address +6 


total. bytes: 6+24n 


The pointer to text address is a pointer to pointer. This object 
is used in EGOS for every text that appears on the screen. The advantage 
of using this structure is that all texts may be changed by changing 
pointers. Therefore application programs can be easily translated to 


other languages. 


VIRTUAL = 20 
Virtual screen 
Flags +0 1 byte 
object type 41 1 byte =VIRTUAL 
coord x +2 2 bytes 
coord y +4 1 byte 
dimension x +5 2 bytes 
dimension y +7 1 byte 
descriptor address +8 2 bytes 
text address +10 2 bytes 
total bytes: 12 
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Descriptor addres- must be a pointer fa a 10 byte buffer i the 
length of a virtual screen descriptor». The obiect drawing routine 


constructs the correct virtual screen descriptor. 


FLAGS 
bit u in objects of type TEXT, TEXTF, TEXTL, EDTEXT 
“0 logic operation CE 
=! logic operation _TSET 
bit d in objects. of type EDTEXT 
=] not send edited text to butte: : 
bit. internal use 
bit 3 internal use 
bit 4 in objects ot type FITIM 
=0 no mask 
=] mask with bit 5 
bit 5 in objecto of type BITIM 
=0 mask “AND with 2 
-1 mask _XOR with 255 
bit 6 in selectable objects 
=] exit of .C FORM function 
bit 4 in ali objects except EDTEXT, TEXT 
=1 selectable 


[3.5) MESSAGES 


The ..C FORM, —I. FORM, ` vw MENU routines store a message in » 
memory address set by the user. This message gives information to the 
user telling him where the cursor is. 


Message interpretation is as follows: 


For _Q_MENU: 
byte +0 =0 Cursor is not inside the menu bar 
EN Cursor is inside, then: 
byte +1 =0 is on the bar but not on an entry 
=n is inside the nth entry, then: 
byte +2 =0 is not inside a submenu 
= is on the mth entry of submenu, then: 
byte +3 =0 


Not selectable entries will not produce any messages. 


For _C_FORM: 
byte +0 =255 
byte +1 and next ones: path of object producing the 


exit. 
Ie. Assuming the object is a TREE, then the 
first byte is 255 and the second one is the touched object in the tree. 
Assuming this object is another tree, then the third 

byte is the touched object in this tree, etc. 


D M M—— 
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Cul 501 


nth tree, 


E.G.O.S. Version 1.5 
For .1 FORM: 
byte +0 =0 The cursor fs not on an obiect. 
420 The curser is on an object 
byte +i and next ones: path ui object below 
(same as _( FORM: 
Not selectable objects are ivnored by these routines. 
Path for an object is as toilows: 
byte tl =0 no object 
=n object n, then: 
byte +2 =0 end 
=m object m, of nth tree, then: 
byte +3 =0 end 
=p object p of sub tree mth o! 
then: 
byte +4 =0 end 
=X etc 
(3:54 LOGIC SPERATIONS 
SEI - D 
_AND = ] 
_OR 2 
-XOR - 3 
NOT = 4 
TSET = 8 
TAND = 9 
_TOR 10 
TXOR = 11 
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S. FUN TIONS 


This is a listing of all GION functions. The following notation 
mili be used in descriptions. 


Name: 

GIOS function: 
Pur pore: 
Entry: 

Return: 
Modify: 

Notes: 


NOTE: 


Name of function 

number to be sent to GIOS 

what the function does 

Register or data needed by the routine. 
Value returned by routine 

Registers or data modified by routine 
Remark: 


All GIOS functions modify the lY register and the HL 


and DE alternative registers 


Name: 


GIOS function: 


Purpose: 
Entry: 
Returns. 
Modifies: 
Notes: 


Nane: 


GIOS function: 


Pur posse: 
Entry: 


Returns: 
Modifies: 
Notes: 


Name: 


GIOS function: 


Purpose: 
Entry: 
Returns: 


Modifies: 
Notes: 


780 GENERAL USE ROUTINES 


_MULTE 

0 

8 bits multiplication 

d,e 

a 

f,b, de 

_MULT 

1 

Multiplication 16 bits # 8 bits 
de multiplicand 

a multiplier 

hl result 

af,b,de, hl 

_DIVM8 

2 

Division and module 8 bits 
de 

h = d/e 

1 = d mod e 

af,b,d,hl 
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Name: 

GIOS function: 
Purpose: 

Entry: 
Returns: 


Modifies: 
Notes: 


Name: 

GJOS function: 
Pur pose: 
Entry: 


Returns: 


Modifies: 
Notes: 


Name: 

GIOS function: 
Pur pose: 
Entry: 
Returns: 
Modifies: 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 
Returns: 
Modifies: 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 
Returns: 
Modifies: 
Notes: 


U 
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DIVM 


Division and module lt bits / 8 bits 
hi VS 

hi = hl/c 

de = hl mod « 

ai, b 


STRCF ëm on 
4 i 

Comparison strings 

b number of bytes 

hl,de pointerz to strings 

z - equals, n: = Not equal 

CN 1 string(hì) © string<‘de) 

hl, de, af 

Strings must not be between 8000-BFFF 


_INKEY 


Reads a character from keyboard 

None 

acc = character or 0 if nc character 
all 


JOY 
6 
Reads joystick 
acc = joystick id number 
acc = direction 
all 


_FUEGO 

7 

Reads trigger button from joystick 
acc = joystick id 

acc = 0 not pressed 255 otherwise 
All 
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Name. 


GIOS tunction 


Put pose 
Ent: y: 
Returns: 
Modifies: 
Notes: 


Name: 


GIOS function: 


Pur pose: 
Entry: 
Returns: 
Modifies: 
Notes: 


Name: 


GIOS function: 


Purpose: 
Entry: 
Returns. 


Modifies: 
Notes: 


Name: 


GIOS function: 


Purpose: 
Entry: 


Returns: 
Modifies: 
Notes: 


tre 
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SCREEN 

8 

Changes screen mode 

acc = screen mode 

ix => screen descriptor 

all 

IX is the desk screen descriptor and is an EGOS 
internal bufter. The user must use this value to 
put strings cr characters on the desk screen, 
sending the «correspondent routine the evalue 
returned in ix by _SCREEN 

Cursor must be hidden 


_S_FAGF 

9 

Sets active page of VRAM and disables sprite» 
acc = page 

None 

All 

Cursor must be hidden 


_S_COLOR 

10 

Sets Background, Foreground and 
Border colors 

System variables 

{FORCLR), (BAKCLR), «BDRCLR) 

None 

All 

Cursor must be hidden 


_S_PALET 

11 

Sets palette 

hl = palette address 

b = number of colors 

None 

All 

Each color is a 2 byte number. Its structure 
is: 

0000 0GGG ORRR OBBB 
Cursor must be hidden 


(RGB quantity? 
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| Name: 


GIOS function: 


Pur pose: 
| Entry: 

Returns: 

Modifies: 
| Notes: 


Name: 


GIOS function: 


Pur pose: 
Entry: 
Returns: 
| Modifies: 
Notes: 


(4.3) 


Name: 


GIGS function: 


Purpose: 
Entry: 


| Returns: 
Modiíies: 
Notes: 


Name: 


GIOS function: 


Purpose: 
Entry: 
Returns: 


Modifies: 
Notes: 


IECHNICAL INFORMATION 


.EXEMAIN 


12 

Executes. routine from main rom (EIOS: 

ix- routine address 

who knows ? 

who know. ? 

EXES Uz 

oy he D 
Executes routine from oubrom (Expanded BIGS: 
ix - routine address 


who knows. 2 


who knows 


BIT IMAGE 


SL TEG 

i4 

Load: icons to video-ram 

hl : graphic address in ram 

ix first object BITIM descriptor address 

b = number of icon. 

None 

Ali 

x coord must be a multiple ot 8 (beginning ci a 
byte) Graphic address and descriptor must. not be 
between 8000-BFFF 

Cursor must be hidden 


-PIC CL 

15 

Draws an icon on a virtual screen at the current 
locate position. 

IX -> virtual screen descriptor. 


HL -» icon descriptor. 

A=0 CY=0 Ok. 

A=i CY=0 Clip right 
-2 CY=1 Clip down 


All except IX register. 
Screen and icon descriptors must not be between 
8000-BFFF. Cursor must be hidden. 
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Name 
sil fan, tion: 
Fur pose: 


Entry: 


Returns: 
Modifiez: 


Notes: 


Name: 

GIOS tunction: 
Fur pose: 
Entry: 


Returns: 
Modifies: 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 


Returns: 
Modifies: 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 


Returns: 
Modifies: 
Notes: 


PRIMITIVES 


TECHNICAL INFORMATION 


PRE 
je 
dtaw- icon 
ix = icon descriptor: 
acc. logic operation 
de = coord x 
i -oord y 
None N 


Ali except ix 
icon descr jptor Must not be between 8000 EFFE 
Cursor mot be hidden 


. FRARRA 

17 

di aw: :«vicr box 

c “olor 

a Logic operation 

ix” rectangle descriptor address 
None 


All exvept ix 
Descriptor must not be between &000- BFFF 
Cur:Or must be hidden 


.PRECT 

18 

draws rectangle 

c = color 

b - shadow 

à - logic operation 

ix= rectangle descriptor address 
None 

All except ix 

Descriptor must not be between 8000-BFFF 
Cursor must be hidden 


.PCAJA 

19 

draws box 

b - background color 

c = border color 

acc= logic operation 

ix= rectangle descriptor address 
None 

All except ix 

Descriptor must not be between 8000-BFFF 
Cursor must be hidden 
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Name: 


GIOS function: 


Pur pase: 
Entry: 


Returns: 
Modifies: 
Noten: 


Name: 


GIOS function: 


Purpose: 
Entry: 


Returns: 


Modifies: 
Notes: 


Nane: 


GIOS function: 


Purpose: 
Entry: 
Returns: 
Modifies: 
Notes: 


Name: 


GIOS function: 


Purpose: 
Entry: 
Returns: 
Modifies: 
Notes: 


Version 


5 TECHNICAL 


.LINEFO 
20 


Draw. poiigonai iine 


c vi CI 

accs* iogi« operation 

hl = Poligonal line descriptor address 

Descriptor: 

points number 10 i. byte 

points *1 * byte each pdin 
chOnd X3 byte 


coordi y i byte 


total bytes: ltotn 


INFORMATION 


Descriptor must not be between 8000 BFFF 


Cursor must be hidden 


MOUSE CURSOR 


CU 

21 

Initiates cursor position 
hl = coord x 

de = coord y 

None 

All except ix 


_CURSTD 

22 

Loads standard cursor to video-ram 
None 

None 

All except ix 

Cursor must be hidden 


_CA_CUR 
23 
Loads cursor to VRAM 


hl = cursor definition address in RAM 


None 
All except ix 


Cursor definition must not be between 8000-BFFF 


Cursor must be hidden 
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Name 


GIOS tum tion: 


Purpose: 
Entry 
Return.: 
Modifies: 
Notes: 


Name: 


GROS tun. tion: 


Fur pose: 
Entry: 
Returns. 
Modities: 
Notes: 


Name: 


GIOS function: 


Pur pose: 
Entry: 
Returns: 
Modifies: 
Notes: 


Name: 


GIOS funetion: 


Purpose: 
Entry: 
Returns: 


Modifies: 
Notes: 


Name: 


GIOS function: 


Purpose: 
Entry: 
Returns: 
Modifies: 
Notes: 


TECHNICAL 

QCUC Un 

24 

Hide 11:501 

None 

None 

Al} exept a 

MUE UE 

show ursol 

None 

None 

Ai} except ix 

A ACIMO! 

co 

Moditie: mouse 

None 

None 

A11 

_WHERE 

27 

Reade mouse 

None 

c = Trigger action 
NO ACTION 0 
TOUCHED 1 
RELEASED 2 
RETOUCHED 3 

acc = button status 
PRESSED 255 
NOT PRESSED 0 


hl = cursor coor y (pixels) 
de = cursor coor x (pixels) 
Al) 


_SPEEDM 

28 

Set speed mouse 
acc = speed (0-7) 
None 

None 


U 


INFORMATION 
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Name 

GIOS fun. tion: 
Pur pose: 

ELT N. 
Returns: 
Modifie 

Notes: 


14.6) 


Name: 

GIYOS func tion 
Pur pose: 
Entry: 
Returns: 
Modities 
Notes: 


Name: 

GIOS function: 
Pur pose: 
Entry: 


Returns: 
Modifies: 
Notes: 


Nane: 

GIOS function: 
Pur pose: 
Entry: 


Returns: 
Modifies: 
Notes: 


toc nannan 


lé 


TECHNICAL INFORMATION 


DELAYS 

29 

Sete celay between touch and touch 

ace s delay oes 

None 

None 

VIDI KRANK . 

Lë? 

30 

Fill. screen desk with one byte 

acc = byte 

None 

All ex ept ix 

acc - 0 clear desk s reen 

Curse: met be hidden 

_R_MOVV 

31 

Moves {rom VRAM to VRAM 

h] = deseriptor address 

Descriptor: 
origin x +6 2 bytes 
origin y +e 2 bytes 
destination x 44 2 bytes 
destination y +6 2 bytes 
dimens:on x +E 2 bytes 
dimension y +10 2 bytes 
logic operation +12 1 byte 
total bytes: 13 

None 


All except ix 
Descriptor must not be between 8000-BFFF 


Cursor must be hidden 


_LDIR_VM 

32 

Moves from VRAM to RAM 
hl = RAM address 


a,de VRAM address 
be number of bytes 
None 


All except ix 
RAM address must not be between 8000-BFFF 


Cursor must be hidden 
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Name: 

GIOS function: 
Pur pose: 
Entry: 


Returns: 
Modifies 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 
Returns: 
Modiiies: 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 
Returns: 
Modifies: 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 


Returns: 
Modifies: 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 
Returns: 
Modifies: 
Notes: 


TECENICAL INFORMATI 


LETR KV 


33 
Move. from NAM to VRAM 
hi FAM aidre. 


a,de VRAM address 


be = number of byte 

None 

Ail except ix 

RAM address must not be between 5000-PRFFF 
Curwor mo-! be hidden H 


LOW LEVEL ROUTINES 


_DISPR 

34 

Disable. prites 
None 

None 

af,b 


Cursor must be hidden 


_OKCOM 

35 

Waits until vdp ready to receive commands 
None 

None 

at 

Cursor must be hidden 


_WINC 

36 

Writes data in vdp registers 
hl = data address 


b = number of registers 
c = initial register 
None 

at, be, hi 


data must not be between 8000-BFFF 
Cursor must be hidden 


aR VDF 

37 

Reads vdp register 
acc= register 

acc= data 

af 

Cursor must be hidden 


iN 


— m—————————————————————— 
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Name 

GICS function: 
Fur pose: 
Entry: 


Returns: 
Modifies: 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 
keturns: 
Modifies: 
Notes: 


Name: 

GIGS function: 
Purpose: 
Entry: 


Returns: 
Modifies: 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 


Returns: 
Modifies: 
Notes: 


TECHNICAL 

WAN DE 
38 
Writes data in vdp register 
cov registi! 
b : data 
None 
a! 
Cursor must be hidden 

BEE} 
39 
Peep sound 

None 

None 
at; bc. Bi 

PSG 
40 

Writes data in FS6 registers 
hi data address 

b number of registers 
C initial register 
None 


af. “be, DI 
data must not be between 8000-PFFF 


_WRTPSG 

41 

Writes data in Psu register 
acc - register 

c = data 

None 

None 


INFORMATION 


Name: 

GIOS function: 
Pur pose: 
Entry: 


Returns: 
Modities: 
Notes: 


Name: 
6165 function: 
Purpose: 


Entry: 


Returns: 
Modifies: 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 
Returns: 
Modifies: 
Notes: 


TECHNICAL INFORMATION 


MOVABLE RECIANGLES 


_RECTAN 


42 

Opens or cio-es rectangle 

ix -: rectangie descriptor 

de «vor x from point 

l cuor y from point d 
a-( open rectangle 

a «* 0 close rectangle e 

None 

Ali 


Descriptor must not be between 8000-BFFF 
Cursor must be hidden 


_S_RMOV 

43 

Initiates tioating rectangle ur elastic 
rectangle 


asi tioating rectangle 
ix = rectangle descriptor 
a-2 elastic rectangle 
de = left upper corner coor x 
] = left upper corner coor y 
Bit 7 i Has limits 
Bit 6 = 1 No movement in X axis». 
Bit 5 = 1 No movement in Y axis. 
IX:6 = Rectangle descriptor of limits. 
None 
All 


Descriptor must not be between 8000-BFFF 
Case of elastic rectangle, the cursor position 
is in the right lower corner 


Moves floating or elastic rectangle 

None 

None 

All 

The rectangle must be initiated by _S_RMOV 


Pag: 30 


E 6.058. Version 1.5 


Name: 

GIOS function: 
Purpose: 
Entry: 
Returns: 
Modifies: 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 


Returns: 
Modifies: 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 


Returns: 
Modifies: 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 
Returns: 
Modifies: 
Notes: 


Que 


TECHNICAL INFORMATION 


.F.RMOV 

45 

Ends floating or elastic rectangle 

None 

Flag z=1 no movement. «Only for floating). 
A11 

Erase the rectangle. 


_Q_RMOV e 

46 

Reads floating or elastic rectangle parameters 
de = address of buffer to store rectangle 
parameters 

Rectangle parameters modified 

DC, de, hl 

DE must not be between 8000-BFFF 


INTERS 

47 

Calcuiates two rectangies' intersection 
ixl rectangles descriptors 


de result address 
carry=1 There is no intersection 
A11 


DE, HL and IX must not be between 8000-BFFF 
Returns the intersection rectangle descriptor 
to the memory pointed by DE 


_CARSTD 

48 

Loads in VRAM the standard character set 
None 

None 

All 

Cursor must be hidden 
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Name: 


GIOS function: 


Purpose: 
Entry: 


Returns: 


Modifies: 
Notes: 


Name: 


GIOS function: 


Purpose: 
Entry: 


Returns: 
Modifies: 
Notes: 


Name: 


GIOS function: 


Pur pose: 
Entry: 
Returns: 
Modifies: 
Notes: 


Nane: 


GIOS function: 


Purpose: 
Entry: 


Returns: 
Modifies: 
Notes: 


TECHNICAL INFORMATION 


GA. CAR 

49 

Loads in VRAM a specified block of 32 chars 
h1 address of char patterns 

a block (0 a 7) 

None 

All 


can Only load blocks from 0 to 3 in screen 8 
hl must not be between 8000-BFFF 


Cursor must be hidden e 
_PCAR 

50 

Puts a character on the screen 

a character 

de coord x (pixels) 

I coord y (pixels) 

None 


373 
ai 


Cursor must be hidden 


_SETLOG 

51 

Sets logic operation for drawing characters 
acc = logic operation 

None 

None 


_CLSV 

52 

Clears virtual screen 

acc color 

ix -> virtual screen descriptor 
None 


All except ix 
Descriptor must not be between 8000-BFFF 
Cursor must be hidden 
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Nane: 


GIOS function: 


Purpose: 
Entry: 


Returns: 
Modifies: 
Notes: 


Name: 


GIOS function: 


Purpose: 
Entry: 


Returns: 


Modifies: 
Notes: 


Name: 


GIOS function: 


Purpose: 
Entry: 


Returns: 
Modifies: 
Notes: 


LLOCATV 

53 

Locates position on virtual] screen 
tee virtual screen descrip"'»r 

de locate x (pixels 

i locate y (pixels: 

None 

None 

Virtual sereen descriptcr must uct be between 
8000-BFFF e 
_CHPUTV 

54 

Puts a character on virtues? veieren 

ix c4 virtual screen Gescrir*o! 

a character 

a=0 carry-0 ok 

a=l carry=0 clip rigè? 

a=2 carry=l clip dow: 


All except ix and hl 

Virtual screen descriptcr must not be between 
8000- BFFF 

Cursor must be hidden 


_PCADV 

55 

Prints a string on a virtual screen 

dx => virtual screen descriptor 

hl string address 

None 

All except ix 

IX and HL must not be between 8000-BFFF 

control characters: 0 End of string 
10 newline 

(no other control characters are recognized) 

Cursor must be hidden 
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[4.11] 


Name: 


GIOS function: 


Purpose: 
Entry: 


Returns: 


Modifies: 
Notes: 


Name: 


GIOS function: 


Purpose: 
Entry: 


Returns: 
Modifies: 
Notes: 


Name: 


GIOS function: 


Purpose: 


Entry: 


Returns: 


Modifies: 
Notes: 


TECHNICAL INFORMATION 


OBJECTS AND FORMS 


—C. FORM 

56 

Opens and draws one dialogue form. This routine 
does not return until the form is close: 


io v iorm descriptor 

bc address of message ° 

ix touched object descriptor 

de coord x of touched objet (absoiote: 
l coord y of touched objet (absolute 
be x dimension of touched objet 

h y dimension of touched objet 


first byte of message=255 
All 
IX and BC must not be between 3060 BEEF 


P FORM 


87 


Draws one form 


ix => descriptor of form 
de coord x 

l coord y 

None 

All 


IX must not be between 8000-BFFF 
Cursor must be hidden 


—I1. FORM" 

58 

Searches the object below Cursor 

The cursor position must be modified using 
_WHERE 

ix -> form descriptor (TREE ROOT) 


de coord x of form (same as .—.P FORM: 

1 coord y of form (same as .P FORM) 

a code to store in message if cursor is 
inside the form. 

bc address of message 


If an object is touched : 
ix -) descriptor of touched object 


de coord x absolute of object 
1 coord y absolute of object 
be dimension x 
h dimension y 

else first byte of message = 0 


All 
IX and BC must not be between 8000-BFFF 
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E.G.O.S. Version 1.5 TECHNICAL INFORMATION 
(4.12) LINE EDITING 
Name: _ INPUT 
GIOS function: 59 
Purpose: Input string (maximum 64 chars) 
Entry: 
Dl SA buffe: to store the string. 
1x 52 virtual screen descriptor e 
de locate input x(d) and y(e) in chars 
b number of chars to read. 
È cursor position inside string 
A control tiags. 


bit 0=1 can input chars 

bit 0=0 cannot input chars 

bit 1=1 can input numbers 

bit 170 cannot input numbers 

bit 2-1 alphanumeric input. Chars > 3l 
scot} 

bit 3-1 print string pointed by hi. 
bit 4-1 not exit if number overt] ows. 


Returns. 
input string in Entry buffer 
acc = exit type. 
a=0 underflow exit 
aci overflow x 
ae escape key touched We TIE 
Ek up cursor key 
a=4 down cursor key 
a=5 return key pressed 
a=6 mouse trigger touched 
c Cursor column. 
Modifies: All 
Notes: HL and IX must not be between 8000-BFFF 
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Name: 


GIOS function: 


Purpose: 
Entry: 
Returns: 
Modifies: 
Notes: 


Name: 


GIOS function: 


Purpose: 
Entry: 
Returns: 


Modi fies: 
Nates: 


TECHNICAL INFORMATION 


. P. MENU 

60 

Draws menu 

hl = menu address 

None 

Ali e 
HL must not be between 8000-BFFF 

Cursor must be hidden 


—Q MENU 

61 

Checks menu 

be -> address to store message 


Carry = 1 when cursor is inside the menu bar o 
on submenu. When cursor is not ove! the menu, 


Carry = 0. 

First byte of message-1 if cursor is on an 
entry 

otherwise, first byte = 0. 

All 


BC must not be between 8000-BFFF 
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Nane: 

GIOS function: 
Purpose: 
Entry: 
Returns: 
Modifies: 
Notes: 


Name: 

GIOS function: 
Purpose: 
Entry: 
Returnz: 
Modifies: 
Notes: 


Name: 

Gios function: 
Purpose: 
Entry: 
Returns: 
Modifies: 
Notes: 


Name: 

Gios function: 
Purpose: 
Entry: 
Returns: 
Modifies: 
Notes: 


fre 


TECHNICAL INFORMATION 


ACCESORIES 


-CALCUL 

62 

Caiculator 

None 

None 

Ali . 
Screen mode must be 6 and page 1 ot VRAM must 
not be corrupted (the calculator uses icon 
definitions.) 


_PANEL 

63 

Controls 

None 

None 

Ali 

Screen mode must be © and page ! of VRAM mus! 
not be corrupted tthe controls use icon 
definitions.) 


_CALEND 

64 

Diary 

None 

None 

All 

Screen mode must be 6 and page l of VRAM must 
not be corrupted. This routine changes the DMA 
address corrupting the FCB. The user must 
provide the ERROR TRAP ROUTINE to prevent disk 
errors because this function uses BDOS disk 
calls. This error trap routine must be between 
C000-FFFF. 


_ERRTRP 

65 

Traps disk errors. 

None : 

C = 1, retry. C = 2, cancel (user action). 
All except IX 

If this GIOS function is used as a disk error 
trapping routine, then, when the function 
returns the Cancel option, it is sent as a 
parameter to 

the system and MSX-DOS executes a jp 0, 
resetting the 

machine. It is better to give the control to 
system when the action is 'Retry' and 
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Name: 

Gios function: 
Pur pose: 
Entry: 
Returns: 
Modifies: 
Notes: 


TECHNICAL INFORMATION 


restart the program by jumping to 2 warm 
start location when the action is ‘Cancel 
If an error is produced in a GIOS function, 
the user must restore the application RAM 
configuration. Otherwise the ‘Cancel’ option 
wili execute a restart of EGOS. 


_LANGUAGE 

66 

Returns the actual language. 

None. ? 
Actuai language in Acc. 

Acc. 
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The following is a listing of ali EGOS messages and their 
maximum lengths. 


Messages with leading spaces are for centering purposes. 


Submenus. have only one line. Every option is separated with a 
backslash. The length of a submenu has no limit. The routine reads all 
options and equates the submenu length to the length ot the longest 
text. There are two leading spaces before each text and two trailing 
spaces at the end of the longest text when needed for centering 
proposes. 

The number of options in the language menu is set to the number 
of entries the routine must read. 

When selecting an option from the language submenu the program 
reads a tile from disk A. If one selects the first language from the 
submenu, the file loaded will be LANGUAGE.000; if he selects the second 
one, the filc loaded will be LANGUAGE. OG) ete. The maximum number ul 
languages that the user can include in the submenu is 9. it is possible 
to edit the file LANGUAGE.QUX with a text edito: such as Word-Master 
MED, etc. 


MESSAGE MAX. LENGTH 
Insert disk = 17 
in drive : 14 
Ok. = 7 
Cancel = 7 
Drive = 7 
Read error = 19 
Write error = 19 
Disk protected = 19 
CRC error E 19 
Disk error = 19 
Printer error = 19 
Printer not = 19 
ready. = 19 
Diary = 38 
Open file = 30 
Can't execute = 30 
Type = 7 
Cancel = v 
Print = 7 
Page = 8 
Line = 8 
Open error. = 18 
File not found = 18 
Calculator = 13 
Controls = 15 
Confirn = 13 
Not confirm = 13 
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E.G.O.S. Version 1.5 TECHNICAL INFORMATION 
Border = 7 
MSX2 Graphic environment = 29 
(c) OPERA SOFT S.A. = 29 
Version = 25 
Can't open = 22 
this icon = 22 
Files = 10 
Bytes free. = 18 
Rename file. = 24 
Old name = 14 
New name = 14 e 
Erase file. = 21 
Confirm option. = 21 
Name : = 8 
Format disks. = 25 
Disk A Single side : = ER 
Disk B Single side : = 22 
Disk B Double side : = 22 
Disk A Double side : = de 
Bad parameter. = 22 
Format complete. = 22 
Formatting ... - 22 
January = 9 
February = 9 
March = 9 
April = 9 
May = 9 
June = 9 
July = 9 
August = 9 
September = 9 
October = 9 
November = 9 
December = 9 
M Tu V Th F Sa Su = 2 char week days 
Copy files = 22 
Copy disks = 22 
From disk : = x 
A: to B: = y xty<=22 
B: to A: = y 
Confirm copy = 22 
A: to A: = y 
B: to B: = y 
Execute program = 22 
Enter parameter list = 25 
Load = 7 
Save = 7 
Save file = 22 
Error. Disk full. = 25 
Confirm option n 25 


----------------- END OF MESSAGES------------------- 
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E.G.O.S. Version 1.5 TECHNICAL INFORMATION 
MENU: 
Desk Actions View Options Language LENGTH = no more than 43 
bytes 
SUBMENUS: 
Submenu 1: 
Versiony -“Glack\<=>=2-=-==<-2-- NO “Calculatar\s TEE ` 
Format 
CA HORE eg rete an pe m oak \ Format 
Submenu 2: 
Run) Rename \ Print Type\ Erase\ Copy 
Submenu 3: 
By icons\ By text\---~----==------ \ By name\ By date\ By size\ By 
kind 
Submenu 4: 
Controls\ Save desk\ Hard copy\------------- \  MSX-BASIC\ MSX-DOS 
Submenu 5: 


English) Espanol\ “Francais Nederlands \  Deutsch\ Italiana` 
Portugues 
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i GIOS FUNCTIONS 


0000 MULTA = 0 ° 
0001 _MULT = 1 
0002 _DIVM8 = 2 
0003 -DIVM = 3 
0004 .SIRCP = 4 
0005 .INKEY = a 
0006 JOY = 6 
6007 .FUEGO = Y 
0008 .SCREEN - 8 
0009 JS PAGE = 9 
QOOA S COLOR” lò 
GOOB _S_PALET= 1] 
000C EXEMAIN= 12 
000D .EXESUB = 13 
000E zb.-IG0 = 14 
000F PIC. CL = 15 
0010 .PBITIM = 16 
0011 _PBARRA = 17 
0012 _PRFECT = 18 
0013 .PCAjA = 19 
0014 -LINEPO = 20 
0015 _1_CUR = ci 
0016 _CURSTD = 22 
0017 CA CUR = ER 
0018 _OCUCUR = 24 
0019 _MUECUR = 29 
OO1A _ACTMOU = 26 
001B _WHERE = eT 
001C .SPEEDM - 28 
001D _DELAYM = 29 
001E _CLSDSK = 30 
001F _R_MOVV = 31 
0020 _LDIR_VM= 32 
0021 _LDIR_MV= 33 
0022 _DISPR = 34 
0023 .OKCOM = 35 
0024 _WIWC = 36 
0025 _R_VDP = 37 
0026 _W_VDP = 38 
0027 -BEEP = 39 
0028 .PSG - 40 
0029 _WRTPSG = 41 
002A -RECTAN = 42 
002B _S_RMOV = 43 
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002C _A_RMOV - 44 
002D _F_RMOV = 45 
002E _Q_RMOV = 46 
002F _INTERS = 47 
0030 .CARSTD = 48 
0031 _CA_CAR = 49 
0032 _PCAR = 50 
0033 _SETLOG = Da 
0034 CLSV = 52 
0035 .LOCATV - 53 
0036 _CHFUTV = 54 E 
0037 .FCADV 55 
0038 -C PORN = 56 
0039 .P.FORM = 9 
003A -I FORM = 58 
003B <INPUT = 59 
003C _P_MENU = 00 
003D .Q. MENU = 61 
003E -CALCUL = 62 
003F PANEL = 63 
0040 .CALEN = 64 
0041 JERRTRP» = 05 
0041 LANGUAG= 66 


0001 TOUCHED = 
0002 RELEASED = 2 
0003 RETOUCHED = 3 
' KA E e R ma mm e a l e -— awe 
! FORMS USED 
1 a m ma we i in bh i —À ——  —— — —— a a A— — mw ——— o m aD mm ew — eo ab em T — —— — — 
0000 TREE  - 0 
0006 TEXT = 6 
000C RECTAN = 12 
000E BARR = 14 


FD9F H_TIMI = Oxfd9f 
F323 ERRPOI = 0xf323 
start: 
0100 21F801 ld hl, tempor 
0103 1100C0 ld de, INIEGOS 
0106 016401 ld bc, message-INIEGOS 
0109 EDBO ldir 


eg 
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010R CDBSO1 call inite tinit GIOS 
warm: 

010F 3183C2 ld op, stack ‘application 
‘stack pointer 

0111 FD211800 ld iy, _OCUCUR ! hide cursor 

0115 CD42C0 call GIOS 

0118 217ACO ld hl, inks 

011B 0604 ld b, 4 , 

OiiD FD210800 ld iy, 5. PALET tuet palette 

0121 CD42C0 call GIOS 

0124 3E02 ld A,2 'ciear desk 
'screen 

0126 FD211E00 ld iy, .CLSDSK 

012A CD42C0 call GIOS 

012D 2182c0 ld hl, menu 'draw menu 

0130 FN213C00 id fy, P MENU 

0134 CD42C0 call GIOS 

0137 DD21D2C0 id ix, objet demo object 

013B 110000 ld de, 0 tx from origin 

013E 2E00 ld 1,0 ty from origin 

0140 FD213900 1d iy, P FORM !show it. 

0144 CD42C0 call GIOS 

0147 FD211900 ld iy, _MUECUR ! show cursor 

014B CD42C0 call GIOS 

loop: 

014E FD211B00 ld iy, _WHERE 'where is the 
cursor ? 

0152 CD42C0 call GIOS 

0155 79 ld a,c 

0156 32B201 ld (event),a !what happens 

0159 0164C1 ld bc, message !buffer to store 
!'the result of 
! Q MENU 

015C FD213D00 ld iy,.Q MENU 

0160 CD42C0 call GIOS 

0163 30E9 jr nc,loop 

0165 3AB201 ld a, (event) 

0168 FE01 cp TOUCHED 'trigger touched 

016A 20E2 jr nz, loop ‘no, again 

016C 3A64C1 ld a, (message) 

016F B7 or a ‘cursor inside 
!menu ? 

0170 28DC jr Z, Loop !no, again 

0172 3A65C1 ld a, (message+l) 
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0175 


Version i.^ 


B7 


» 28D0 


3A60C1 
B7 


7C 2BD0 


01B2 


87 

SF 
1600 
21A601 


E9 callhi: 


FD213E00 calcul: 


C342C0 


FD213F00 
C342C0 


panel: 


FD214000 
C342C0 


diary: 


C9 none: 


A501900197019E01A501D501 \ 
tsal: . data2 


00 event: 


or 


ret 


z.loop 


a, (mensaget?) 


a 


Pal oop 


a,a 
e,a 
d, 0 
h]l, tsal 


hi, de 

e, (hl) 
hl 

a, CaJè 
de, h) 


callh! 


loop 


(hl) 


1y, .CALCUL 


GIOS 


iy, PANEL 
GIOS 


iy, CALEN 
GIOS 


U 


TECHNICAL INFORMATION 


‘cursor is 
"inside one 
tentry 7 

‘no. again 


'cursor is 
‘inside 

! submenu 7 
'no, again 


'tabie of 
! routines 
tfo: each 
toubmenu 


{hie routine 


‘execute routine 
‘from submenu 


'again 


tcalculator 


tcontrol routine 


‘calendar 


none, calcul, panel, diary, none, exit 


.datai 


0 
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lio 


E.G O.S. 
0:83 CDC0:0 
HEET 
01BS FDZiv800 


EDAZEO 
> FD. 2.200 


CD4 2.0) 
PHS. 500 


Chaz: v 


= BD215000 


CD42.6 


Co 


. FD2:1500 


CD42:.6 
SEG. 


= FD210500 
: CD420.0 


C3210 


210000 
11F801 
016401 
EDEC 

C30000 


Version 1.5 


TiS. BECH INFORMATION 


 -—————-——-- ——— A - e EH E =Š pa 
; INIT SCREEN AND GIOS “UN TIC 
——é—b——b—ébé———— pm mm — - n mme ke es im Seo Es 26 ba I 
inite: 
call INT EGO: tinit gios 
‘function 
ld a, D 
ld iy, SCREEN "screen mode 6 
call GIOS 
ld iy, DISPR "disable sprites 
call GIOS ^ 
ld iy, CURSTE + oad standard 
“cursor in VRAM 
call GIOS 
ld iy, CARSID ' gad standard 
‘character set 
*in VRAM 
call G105 
ret 
exit 
ld fy, OCUCUR ‘hide cursar 
call GIOS 
ld a, 0 
ld iy, SCREEN ‘screen mode È 
call GIOS 
jp EXIEGOS texit 
‘application 
move: 
ld hl, INIEGOS 
ld de, tempor 
ld bc, message-1NI EGOS 
ldir 
jp 0 
' c —— d — n A M e 9 en soe eww oe Oe we —— — on a —— a oe "P." ne m Ml 
t RAM SPACE RESERVED FOR DATA 


olderr: .space 2 


tempor: 


ITT TZ TTT CTT OTTELE EEE EE 
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F3 


2A2C00 


224AC0 
226DC0 
219FFD 
1174C0 
010500 
EDBO 

3EC3 

329FFD 
215FCO 


22A0FD 
2A23F3 
22F601 
2144C1 
2223F3 
c9 

F3 
2174C0 
119FFD 
010500 
EDBO 
2AF601 
2223F3 


C30000 


D 


TECHNICAL INFORMATION 


1355511111111119 


pag z Oxfc ^ 
pag! = Oxid 
pape = Oxfe 
INIEGOS: 
di 'disable 
tinterruptions 
ld hl, (Ox2c) 'GIOS ADDRESS 
! IN EGOS 
ld txmodOti),hl 
id (xmod1+1), hi 
ld hl, H TIMI ‘interrupt hook 
id de, memint 
ld DC, D 
ldir 
ld a, 0xc3 !jp code 
ld (H_TIMI),a 
ld hl, intrup fuser interrupt 
'routine 
id CH. TIMI+1), hi 
ld hl, (ERRFOI) !pointer to 
‘error trapping 
troutine address 
ld (olderr),hl 
ld hl, error !new error 
!pointer routine 
ld (ERRPOI), hl 
ret 
EXIEGOS: 
di 'disable 
tinterruptions 
ld hl, memint ‘old 
! interruptions 
ld de, H_TIMI 
ld bc,5 
ldir 
ld hl, (olderr) 
ld (ERRPOI), hl ‘old error 
! pointer 
JP 0 texit 
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€042 
C043 
C045 


C048 


(049 


C04C 
C04D 
C04F 


C052 
C053 


C054 
C05 
6057 
C058 
COSA 
COD H 
CO5D 
COSE 


CO5F 
C061 


C064 
C066 
C068 


CO6C 
CO6F 
C072 
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Ui OE: 
FS 
3E06 
CD54C0 


F1 
xmodo: 
CD0000 


PS 
3E03 
CD54c0 


setram: 


DBFE 
3279C0 


3E04 
D3FE 
FD211A00 
xmodl: 
CD0000 
3A79C0 
D3FE 


menint: 


call 


out 


af 
a,6 
setram 


af 
0 


of 
a,3 
setram 


af 


(pag2),a 
a 
(pagl),a 
a 
(pag2),a 


a, (pag2) 
(memram),a 


a,4 


(pag2),a 
iy, _ACTMOU 


0 
a, (memram) 


(pag2),a 


D 


TECHNICAL INFORMATION 


'set EGOS 
"program 
tin RAM 


teal) GIOS 
! FUNCTION 


‘restore 
application 
! program 


tset memory map 


! preserve 
‘current 

! RAM 

‘from 8000 to 
!C000 


'set EGOS 
! move mouse 


trestore initial 
! value 

‘of RAM 

‘old interrupt 
troutine 


~p 
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TECHNICAL INFORMATION 


‘entries ot menu 
{pointer to text 
'first column 

! char 

tinternal use 

! pointer to 
‘first 

'submenu 
‘internal use 


"text of menu 
‘end of text 


! submenu 
'entries of 

! submenu 

! maximum length 
‘of each text 

! pointer to text 
tselectable 
tselectable 
tselectable 
tnot selectable 
tselectable 
tend of submenu 


!'text of 
!first entry 


L DATA 
| go————————————————————————— JT m ul 
inks 
COTA 7707 .data2 0x777 
C07C 0602 .data2  0x206 
CO7E 0206 .data2  0x602 
C080 0000 .data2 0x000 
menu: 
C082 01 .datal 1 
C083 8ACO .data2 texbar 
C085 02 .datal 2 
space 1] 
C087 91C0 .data2 smenui 
.space 1 
CORA 204N656E?520 texbar: .ascii ' Menu ' 
C090 00 .datal 0 
smenul: 
C091 05 .datal 5 
C092 OE .datal 14 
C093 9BCO .data2  texsml 
C095 80 .datal 0x80 
C096 80 .datal 0x80 
C097 80 .datal 0x80 
C098 00 .datal 0 
C099 80 .datal 0x80 
CO9A 00 .datal 0 
C09B 202043616C63756C61746F720A \ 
texsml: .ascii ' Calculator\n' 
COA8 2020436F6E74726F6C730A \ 
.ascii ‘ Controls\n' 
COB3 202044696172790A .ascii ‘  Diary\n' 
COBB 2D2D2D2D2D2D2D2D2D2D2D2D2D2D0A \ 
H K Eegen 
COCA 2020457869740A “ascii * ExitNn’* 
COD1 00 .datal 0 


tend of text 
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CODC 
004A 


COD2 
Cona 
COD4 
CODO 
COD7 
COD9 
CODA 
CODB 
CODD 
CODF 
COE] 
COE3 


COE5 
COE6 
COE7 
COE9 
COEA 
COEC 
COED 
COEE 


COEF 
COFO 
COFI 
COF3 
COF4 
COF6 
COF7 


COF8 
COF9 
COFA 
COFC 
COFD 


COFF 
C100 
C101 
C103 
C104 


80 
00 
R400 
40 
TC DU 
4A 
05 
ESCO 
EFCO 
F8CO 
FFCO 
06C1 
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D 


1911181311115111 


LAJ 


WES RESESZESESSSE SESE S SES ES EES SESE ESSE EARS) 


1 

width x 
height - 
objet: 


.datal 
.datal 
.data2 
.datai 
. data2 
.datal 
.datal 
. data2 
. data2 
. data2 
. data2 
. data2 


ver: 


.datal 
.datal 
. data2 
. datal 
.data2 
.datal 
.datal 
.datai 


bver: 


.datal 
.datal 
. data2 
.datal 
. data2 
. datal 
.datal 


tverl: 


.datal 
.datal 
.data2 
.datal 
.data2 


tver2: 


.datal 
.datal 
. data2 
.datal 
. data2 


height 
5 

rver 
bver 
tverl 
tverz 
tver3 


0 
RECTAN 


BARR 

3 

1 
width-4 
height-4 


'selectable 
t TREE 

tx voojd 

hy coord 

'x dimension 
ty dimension 


17 


7 objects 


! posx 

! posy 
'dimx 
'dimy 

! ink 

! shadow 


! posx 
! posy 
'dimx 
!dimy 
tink 
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‘ 
dio 


— AN 


U 
TEXT 
39 
44 


mess3 


fre 


TECHNICAL INFORMATION 


‘Demo program of G.I.O.S.' 


VAI 


OPERA SOFT S.A." 


: 1987' 

errord 'disk error 
troutine 

at 

a, (pago) 'CURRENT RAM 
CONFIGURATION 

(tmp),a 

af 

iy, _ERRTRP 

GIOS tgios function 

af 

a,c 

e l CARCEL" 2 

Z, warm !WARM START OF 
t APPLICATION 

a, (tmp) 

setram trestore ram 
!configuration 

af 

1 ! temporary storage 

32 !maximun length of 

! message 
255 ‘stack 


E.G.O.S. Version 1.5 

t ver: 
C106 00 .datai 
C107 06 .datal 
C108 2700 . data? 
C10A 2C . datal 
C10R 3AC1 . data2 
C10D 44656D6F2070726F6772616D206F660:0472E492E4F2E532E00O \ 

messi: .asciz 
C126 284329204F5045524120534F4065420532E412E00 \ 

messi: Wat: 
GISA 20202020203139383700 N 

mess3: .ASTIZ 
C144 46C1 error: . data2 

errord: 
C146 F5 push 
C147 DRFC in 
C149 5263Cl ld 
C14C Fl pop 
C14D FDZ2141006 la 
C15i CD42CO call 
C154 F5 push 
C155 79 ld 
C156 FEO2 cp 
C158 CAOEUI jp 
C15B 3A63C1 ld 
CISE CD54CO call 
C161 FI pop 
C162 C9 ret 

tmp: . Space 

message: 

. Space 
. Space 
stack: 
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